Skip to main content
Version: v25.06

命令参考

本文档是Cluster API安装部署的命令参考内容。

构建安装部署包​

  • 命令

    bke build

  • 命令功能

    构建安装部署包，收集二进制文件、rpm包、chart包等进行部署包的构建。

  • 命令格式

    1. 根据yaml构建部署包。

      bke build -f <yaml file path, eg: offline-artifacts.yaml> -t <target file path, eg: bke.tar.gz>

    2. 查看命令帮助。

      bke build -h

  • 参数说明

    参数名称描述
    -f, --file指定配置文件路径。
    -h, --help显示命令帮助信息。
    -s, --strategy设置镜像同步策略（registry/docker，默认registry）。
    -t, --target指定打包BKE文件输出路径。

  • 执行用户

    该命令是由root用户执行。

  • 使用前提

    已安装好bkeadm。

  • 注意事项

    无

初始化引导节点​

  • 命令

    bke init

  • 命令功能

    初始化引导节点，包括节点检查、仓库启动、集群安装等操作。

  • 命令格式

    1. 初始化引导节点。

      bke init

    2. 初始化引导节点并部署管理集群。

      bke init --file <cluster configuration file path, eg: /root/openfuyao/bkecluster.yaml>

    3. 指定镜像源安装。

      bke init --otherRepo <other repo, eg: harbor.openfuyao.com/openfuyao/bke-online-installed:v0.0.3>

    4. 自定义镜像源和软件源。

      bke init --otherRepo <other repo, eg: harbor.openfuyao.com/openfuyao/bke-online-installed:v0.0.3> --otherSource <other source, eg: http://192.168.1.120:40080>

    5. 查看命令帮助。

      bke init -h

  • 参数说明

    参数名称描述
    -f, --file指定bkecluster.yaml配置文件路径（必填）。
    -h, --help显示命令帮助信息。
    --chartRepoPort设置Helm Chart仓库端口（默认：38080）。
    --clusterAPI指定cluster-api-bke版本（默认：v25.03）。
    --confirm跳过确认提示，直接执行。
    --hostIP指定本地Kubernetes API Server的IP地址（必填）。
    --kubernetesPort设置本地Kubernetes API端口（默认：36443）。
    --ntpServer配置NTP服务器（默认：cn.pool.ntp.org:123，local表示使用本地服务）。
    --otherRepo指定镜像仓库地址（如Helm Chart、容器镜像等）。
    --otherSource自定义系统软件包安装的私有源地址。
    --runtime选择容器运行时（docker或containerd，默认：containerd）。
    -s, --runtimeStorage设置容器运行时存储目录（默认：/var/lib/docker或/var/lib/containerd）。
    --yumRepoPort设置YUM仓库端口（默认:40080）。

  • 执行用户

    该命令是由root用户执行。

  • 使用前提

    1. 已安装bkeadm。
    2. 已准备好集群配置文件。

  • 注意事项

    无。

集群操作​

  • 命令

    bke cluster

  • 命令功能

    集群的生命周期管理。

  • 命令格式

    1. 集群的安装部署。

      bke cluster create -f <cluster configuration file path, eg: /root/openfuyao/master.yaml>

    2. 查看命令帮助。

      bke cluster -h

  • 参数说明

    参数名称描述
    -h，--help命令帮助。

  • 执行用户

    该命令是由root用户执行。

  • 使用前提

    1. 已安装bkeadm。
    2. 已准备好集群配置文件。

  • 注意事项

    无。

集群卸载​

  • 命令

    bke reset

  • 命令功能

    清理引导节点服务并将节点恢复至裸机状态。

  • 命令格式

    1. 删除本地kubernetes服务。

      bke reset

    2. 清除引导节点及挂载目录。

      bke reset --mount

    3. 清空节点容器及运行时环境。

      bke reset --all

    4. 清除节点服务并跳过删除确认。

      bke reset --all --confirm

    5. 查看命令帮助。

      bke reset -h

  • 参数说明

    参数名称描述
    --all恢复节点。
    --confirm跳过所有删除确认。
    -h, --help显示重置命令帮助信息。
    --mount移除解压目录和相关服务。

  • 执行用户

    该命令是由root用户执行。

  • 使用前提

    1. 已安装bkeadm。
    2. 已准备好集群。

  • 注意事项

    无。